Skip to content

docs(gobus-mcp): conectar o Claude Code com type http em /mcp, sem barra final - #56

Merged
nitaibezerra merged 1 commit into
mainfrom
docs/gobus-mcp-http-transport
Nov 11, 2026
Merged

nitaibezerra merged 1 commit into
mainfrom
docs/gobus-mcp-http-transport

Conversation

@nitaibezerra

Copy link
Copy Markdown
Contributor

Parte da Onda 1 de redução de custos do GCP (destaquesgovbr/infra#223). Acompanha destaquesgovbr/gobus-mcp#18, que remove o transporte SSE legado (/sse + /messages/) do servidor.

O que muda

Em docs/modulos/gobus-mcp.md, seção "Conectar ao servidor":

  • A aba "Claude Desktop / Code" mandava usar "transport": "http" com a URL .../mcp/. O Claude Code usa a chave "type": "http", e a URL deve ir sem barra final: em produção, POST /mcp/ responde 307 para http://…/mcp, enquanto POST /mcp responde 200.
  • A aba virou duas:
    • Claude Code: claude mcp add --transport http gobus https://destaquesgovbr-gobus-mcp-klvx64dufq-rj.a.run.app/mcp -s user, o JSON equivalente (type/url) e a migração para quem ainda tem "type": "sse".
    • Claude Desktop / claude.ai: conector remoto com a URL .../mcp. O claude_desktop_config.json não aceita o bloco type/url.
  • Na tabela de stack, o transport passa a ser "Streamable HTTP stateless em /mcp".
  • A entrada stdio local passa a se chamar gobus-local, como no .mcp.json do repo, para não colidir com o gobus remoto.

Nenhuma outra página de módulos, guias ou onboarding recomendava /sse para o gobus. As menções a SSE em visao-geral.md, adr-002, arquitetura-gcp.md, portal.md e graphql-api.md são do /graphql/stream do agente de IA e não mudam. Os posts de blog também ficam como estão.

Validação

mkdocs build num venv com mkdocs/mkdocs-material instalados do PyPI (sem poetry): ok, com as mesmas 98 warnings preexistentes do main e nenhuma nova. Conferi no HTML gerado as abas novas, o "type": "http" e que não sobrou URL com /mcp/.

🤖 Generated with Claude Code

…rra final

A página do módulo mandava usar "transport": "http" com a URL .../mcp/.
O Claude Code usa a chave "type", e com a barra final o servidor responde
307. Separa as abas Claude Code (claude mcp add --transport http) e
Claude Desktop / claude.ai (conector remoto), avisa que o /sse foi
removido do servidor e renomeia a entrada stdio para gobus-local.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@nitaibezerra
nitaibezerra merged commit b799bf7 into main Nov 11, 2026
2 checks passed
@nitaibezerra
nitaibezerra deleted the docs/gobus-mcp-http-transport branch November 11, 2026 21:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant